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1.  Introduction 


This  report  presents  a  set  of  funetions,  written  in  C++,  that  ean  be  used  to  read,  write,  and  parse 
text  files. 

A  summary  sheet  is  provided  at  the  end  of  this  report.  It  presents  the  yIo2  namespaee,  whieh 
eontains  the  ReadTextFile(),  WriteTextFile(),  RemoveLineComments(), 
RemoveBloekCommentsO,  Parse(),  Parse2D(),  and  PreParse()  funetions. 


2.  Background 


I  previously  published  a  report  titled  Reading,  Writing,  and  Parsing  Text  Files  Using  C++,- 
which  was  very  similar  to  this  report.  Unfortunately,  the  code  presented  in  that  report  contained 
several  errors.  This  report  fixes  those  errors  and  introduces  several  other  improvements.  A  new 
function,  PreParse(),  has  also  been  added. 


The  following  changes  from  the  previous  code  affect  function  behavior; 

•  The  default  value  for  the  WriteTextFile()  function’s  mode  parameter  has  been  changed 
from  "w"  to  "wb". 

•  When  using  the  default  parameters,  the  RemoveBloekCommentsO  function  previously 
interpreted  "*/*"  as  a  complete  block  comment. 

•  The  size  of  the  output  vector  of  the  ParseQ  function  was  previously  never  less  than  1 ,  even 
if  the  function  was  passed  a  pointer  that  pointed  to  a  NULL  character. 

•  The  Parse2D()  function  previously  could  only  parse  text  that  ended  with  a  delimiter. 


3.  Reading  and  Writing  Text  Files 


3,1  ReadTextFileO  Function 

The  ReadTextFileO  function  can  be  used  to  create  a  character  array  that  contains  all  of  the 
information  from  a  text  file. 

Note  that  the  ReadTextFileO  function  uses  the  new[]  operator  to  allocate  memory  for  the 
character  array  that  is  pointed  to  by  its  return  value.  Thus,  to  avoid  memory  leaks,  each  use  of 
the  ReadTextFileO  function  should  be  accompanied  by  a  use  of  the  delete[]  operator. 
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ReadTextFileQ  Code 


inline  char*ReadTextFile(//<=============================READ  TEXT  FROM  A  FILE 

const  char*f){//< - THE  NAME  OF  A  TEXT  FILE 

FILE*F=fopen(f/'rb");/*->*/if( !F)printf("\nCan't  find  \"%s\" . \n",f ) ,exit(l); 
unsigned  n;/*<-*/fseek(F,0,SEEK_END),n=ftell(F), rewind(F); 
char*s=new  char[n+l];/*<-*/fread(s,l,n,F),fclose(F),s[n]=0; 

return  s;// . note  that  s  points  to  newly  allocated  memory 

"^11  E  N  AUT  ^^GI^AI  L  •  LAS  T^U  PDAT  E  D^2  0  D  U  L  2  0  ^4^'**'^'**'^'**' 


ReadTextFileQ  Parameters 
f  f  points  to  the  name  of  a  text  file. 

ReadTextFileQ  Return  Value 

The  ReadTextFileQ  function  returns  a  pointer  to  the  beginning  of  a  character  array  that  stores  all 
of  the  information  from  the  file  specified  by  the  input  parameter  f. 

If  the  file  that  is  specified  by  f  cannot  be  opened,  the  ReadTextFileQ  function  calls  the  exitQ 
function  with  status  code  1 .  Inability  to  open  a  file  is  typically  the  result  of  an  incorrectly 
specified  filename  or  path. 

3,2  WriteTextFileQ  Function 

The  WriteTextFileQ  function  can  be  used  to  write  text  to  a  file. 

WriteTextFileQ  Code 

inline  unsigned  WriteTextFile(//<=========================WRITE  TEXT  TO  A  FILE 

const  char*f,//< - THE  NAME  OF  THE  TEXT  FILE 

const  char*s,//< - THE  TEXT  TO  BE  WRITTEN 

const  char*m="wb"){//< - USE  "wb"  TO  OVERWRITE,  "ab"  TO  APPEND 

FILE*F=fopen(f ,m) ; /*- >*/if ( ! F)printf ( "\nCan ' t  open  \"%s\" . \n",f ),exit(l) ; 
unsigned  n=fwrite(s,l, strlen(s), F);/*&*/fclose(F); 

return  n;// . number  of  characters  written  to  the  file 

"^11  E  N  AUT  ^^GI^AI  L  •  /«*»/«*» /vi/vi/vi/vr/vi/vr/vi  LAS  T^U  PDAT  E  D^2  0  D  U  L  2  0 14^^^^^^ 


WriteTextFileQ  Parameters 

f  f  points  to  the  name  of  the  text  file  that  will  be  written  to. 

s  s  points  to  the  text  that  will  be  written  to  the  text  file. 

m  m  specifies  how  text  will  be  written  to  the  output  file.  Use  "wb"  to  overwrite  an 

existing  file.  Use  "ab"  to  append  to  the  end  of  an  existing  file.  In  either  case,  if  a 
file  with  the  same  name  as  the  output  filename  doesn’t  already  exist,  a  new  file 
will  be  created.  The  default  value  is  "wb". 
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WriteTextFileQ  Return  Value 

The  WriteTextFileO  function  returns  the  number  of  characters  that  were  successfully  written  to 
the  output  file. 

If  the  file  that  is  specified  by  f  cannot  be  opened,  the  WriteTextFileO  function  calls  the  exitQ 
function  with  status  code  1 .  Inability  to  open  a  file  is  often  the  result  of  an  incorrectly  specified 
filename  or  path.  However,  it  can  also  be  the  result  of  a  file  being  marked  as  read  only,  as  may 
be  the  case  if  a  file  is  open  in  another  program. 

3,3  ReadTextFile()/WriteTextFile()  Example 

The  following  example  uses  the  WriteTextFileO  function  to  create  a  file  named  "example.txt". 
The  ReadTextFileO  function  is  then  used  to  read  the  newly  created  file. 

#include  "y_io_2. h"// . yIo2, <cstdio>{printf } 

int  main(){//<=====SIMPLE  EXAMPLE  FOR  WriteTextFileO  &  ReadTextFileO  FUNCTIONS 
yIo2: : WriteText File ( "example .txt", "Hello  World ! \n") ; 
char*s=yIo2: : ReadText File ( "example .txt" ) ; 

printf("%s",s);// . display  the  contents  of  "example.txt" 

delete[]s; 

^11  E  N  AUT  ^)GI^AI  L  •  LAS  T^U  PD  AT  E  D^2  0  D  U  L  2  0 


OUTPUT; 


Hello  World! 


4.  Comment  Removal 


4,1  RemoveLineCommentsO  Function 

The  RemoveLineCommentsO  function  can  be  used  to  overwrite  line  comments.  A  line  comment 
is  a  comment  that  begins  with  some  identifying  set  of  characters  and  continues  to  the  end  of  the 
line.  Memory  that  is  occupied  by  line  comments  is  not  actually  freed  by  the 
RemoveLineCommentsO  function.  Instead,  each  line-comment  character  is  replaced  with  a  user- 
specified  character. 

RemoveLineCommentsO  Code 

inline  char*RemoveLineComments(//<=====================0\/ERWRITE  LINE  COMMENTS 

char*s,//< - TEXT  THAT  MIGHT  CONTAIN  LINE  COMMENTS 

const  char*c  =  "#",//< - BEGINNING-OF-COMMENT  INDICATOR 

char  r='  '){//< - THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

for(char*t=s;t=strstr(t, c) ;memset(t, r, strcspn(t, "\n\f\r" ) ) ) ; 
return  s; 

}//  YAGENAUT@GMAIL.COM - LAST~UPDATED~20DUL2014 - 
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RemoveLineCommentsO  Parameters 

s  s  points  to  text  that  will  have  its  line  comments  overwritten. 

c  c  points  to  text  that  specifies  the  beginning  of  a  line  comment.  The  default  value 

is  "#". 

r  r  specifies  the  character  that  will  be  used  to  replace  the  characters  in  the  line 

comment.  The  default  value  is  a  space. 

RemoveLineCommentsO  Return  Value 

The  RemoveLineCommentsO  function  returns  the  input  pointer  s. 

4,2  RemoveBlockCommentsO  Function 

The  RemoveBlockCommentsO  function  can  be  used  to  overwrite  block  comments.  A  block 
comment  is  a  comment  that  begins  with  some  identifying  set  of  characters  and  ends  with  a 
(potentially)  different  set  of  identifying  characters.  Block  comments  may  or  may  not  span 
multiple  lines.  Memory  that  is  occupied  by  block  comments  is  not  actually  freed  by  the 
RemoveBlockCommentsO  function.  Instead,  each  block-comment  character  is  replaced  with  a 
user-specified  character. 

If  the  RemoveBlockCommentsO  function  encounters  a  beginning-of-comment  indicator,  but  not 
an  end-of-comment  indicator,  then  the  entire  comment  is  ignored.  The 

RemoveBlockCommentsO  function  does  not  recognize  nested  block  comments  as  being  nested. 

RemoveBlockCommentsO  Code 

inline  char*RemoveBlockComments(//<===================OVERWRITE  BLOCK  COMMENTS 

char*s,//< - TEXT  THAT  MIGHT  CONTAIN  BLOCK  COMMENTS 

const  char*c  =  '7*'L//< - BEGINNING-OF-COMMENT  INDICATOR 

const  char*e="*/'L//< - END-OF-COMMENT  INDICATOR 

char  r='  '){//< - THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

int  m=strlen(c),n=strlen(e); 

for(char*t=s, *u;t=strstr(t, c) ;memset(t, r, u-t+n) )if ( ! (u=strstr(t+m,e) ) )break; 

return  s;// . block  comments  without  end  indicators  aren't  overwritten 

}//  YAGENAUT@GMAIL.COM - LAST~UPDATED~20DUL2014 - 


RemoveBlockCommentsO  Parameters 

s  s  points  to  text  that  will  have  its  block  comments  overwritten. 

c  c  points  to  text  that  indicates  the  beginning  of  a  block  comment.  The  default  value 

is  7*". 

e  e  points  to  text  that  indicates  the  end  of  a  block  comment.  The  default  value  is 

1?^  yt? 
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r  r  specifies  the  character  that  will  be  used  to  replace  the  characters  in  the  line 

comment.  The  default  value  is  a  space. 

RemoveBlockCommentsO  Return  Value 

The  RemoveBlockCommentsO  function  returns  the  input  pointer  s. 

RemoveLineCommentsO/RemoveBlockCommentsO  Example 

The  following  example  code  uses  the  RemoveLineComments()  and  RemoveBlockCommentsO 
functions  to  overwrite  comments  in  a  sample  block  of  text. 


ttinclude  "y_io_2 . h"// . yIo2, <cstdio>{printf } 

int  main( ){//<===SIMPLE  EXAMPLE  FOR  RemoveLineComments( )  &  RemoveBlockCommentsO 
char  s[]="#sample  line  comment\nHello/*sample  block  comment*/World ! \n"; 
printf C'ORIGINAL  TEXT : \n%s\n\n" , s) ; 

printf("LINE  COMMENTS  REMOVED: \n%s\n\n",yIo2: :RemoveLineComments(s)); 
printfC'LINE  &  BLOCK  COMMENTS  REMOVED: \n%s\n\n",yIo2: : RemoveBlockComments(s) ); 
^11  YAG  E  N  AUT  ^^GI^AI  L  •  LAS  T^U  PDAT  ED'^20DUL20  *1  r\j  r\j 


OUTPUT; 


ORIGINAL  TEXT: 

#sample  line  comment 
Hello/*sample  block  comment*/World ! 

LINE  COMMENTS  REMOVED: 

Hello/*sample  block  comment*/World ! 

LINE  COMMENTS  AND  BLOCK  COMMENTS  REMOVED: 
Hello  World! 


5.  Parsing  Text 


5,1  ParseQ  Function 

The  Parse()  function  can  be  used  to  separate  the  text  into  tokens.  Tokens  are  blocks  of  text  that 
are  separated  by  delimiting  characters.  Common  delimiters  are  commas,  tabs,  and  spaces. 

The  Parse()  function  works  by  searching  for  tokens.  When  a  token  is  found,  the  delimiting 
character  that  immediately  follows  the  token  is  replaced  by  the  NULL  character,  and  a  pointer  to 
the  beginning  of  the  token  is  stored  in  a  vector.  Any  set  of  consecutive  delimiter  characters  are 
interpreted  as  a  single  delimiter.  For  example,  suppose  that  the  text  "8,„9"  is  parsed  using  the 


5 


Parse()  function  with  d  set  to  The  Parse()  funetion  will  treat  the  set  of  3  eonseeutive  eomnias 
as  a  single  delimiter.  Thus,  only  2  tokens  will  be  found. 

ParseO  Code 

inline  std: : vector<char*>Parse(//<===================================lD  PARSER 

charts, //< - TEXT  THAT  WILL  BE  PARSED 

const  char*d="  , \t\n\f \r" ){//< - DELIMITERS 

std: : vector<char*>\/;/*<-*/for(s=strtok(s,d); s; s=strtok(0,d) )V.push_back(s); 
return  V; 

^11  E  N  AUT  ^^GI^AI  L  •  LAS  T^U  PDAT  E  D^20  D  U  L  2  0 

ParseO  Parameters 

s  s  points  to  text  that  will  be  parsed. 

d  d  points  to  a  set  of  token-delimiting  characters.  By  default,  spaces,  eommas,  tabs, 

line  feeds,  form  feeds,  and  carriage  returns  are  all  treated  as  delimiters. 

ParseO  Return  Value 

The  ParseO  function  returns  a  vector  of  pointers.  Each  pointer  points  to  the  beginning  of  a  token. 
The  tokens  are  stored  in  the  character  array  that  was  originally  pointed  to  by  the  input  parameter 
s. 

ParseO  Example 

The  following  example  uses  the  Parse()  funetion  to  parse  a  sample  bloek  of  text. 


#include  "y_io_2 •  h"// . yIo2, <cstdio>{printf },< vector > 

int  main(){//<===========================SIMPLE  EXAMPLE  FOR  THE  Parse()  FUNCTION 


char  s[]="1.0  2.0  3.0\n4.0  5.0  6.0\n7.0  8.0  9.0"; 
printf O'ORIGINAL  TEXT : \n%s\n\n" , s) ; 
std: : vector<char*>A=yIo2: :Parse(s); 
printfC'TEXT  PARSED  USING  ParseO:\n"); 

for(int  i=0,m=A. size( ) ; i<m;++i)printf ( "%s%s",A[i] , i==m-l?"\n" : "  ,  "); 

^  j  !  ^^<n//s//s//n/YAG  E  N  AUT  ^)GI^AI  L  •  GOI^*^*^*^*"^*^*"*’*^'"^*^*^*^*^*^^*^*^^^*^*^*^*^*^^^  LAS  T^U  PDAT  E  D^2  0  D  U  L  2  0 


OUTPUT; 


ORIGINAL  TEXT: 

1.0  2.0  3.0 

4.0  5.0  6.0 

7.0  8.0  9.0 

TEXT  PARSED  USING 
1.0  ,  2.0  ,  3.0  , 

ParseO  ^ 

4.0  ,  5.0  ,  6.0  ,  7.0  ,  8.0  ,  9.0 

5,2  Parse2D0  Function 

The  Parse2D()  function  can  be  used  to  separate  the  text  contained  in  a  character  array  into 
tokens.  Tokens  are  separated  by  2  types  of  delimiting  characters.  The  first  set  of  delimiters 
separates  tokens  within  a  row  of  data.  Common  examples  are  spaees,  commas,  and  tabs.  The 
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second  set  of  delimiters  separates  data  rows.  Common  examples  are  line  feeds,  form  feeds,  and 
carriage  returns. 

The  Parse2D()  function  works  by  searching  for  rows,  which  are  separated  by  row-delimiting 
characters.  When  a  row  is  found,  the  delimiting  character  that  immediately  follows  the  row  is 
replaced  by  the  NULL  character.  The  Parse()  (not  2D)  function  is  then  used  to  parse  the  row. 
Any  set  of  consecutive  delimiting  characters  acts  as  a  single  delimiter. 

Parse2D()  Code 

inline  std: :vector<stcl: :vector<char*>  >Parse2D(//<=2D  PARSER  (CALLS  ID  PARSER) 

char*s,//< - TEXT  THAT  WILL  BE  PARSED 

const  char*d="  ,\t",//< - TOKEN-DELIMITING  CHARACTERS 

const  char*e="\n\f\r"){//< - ROW-DELIMITING  CHARACTERS 

std: :vector<std: : vector<char*>  >V; 
char*b, *c=new  char[strlen(d)+strlen(e)+l] ; 

for(strcat(strcpy(c,d),e);*(b=s+strspn(s,c));V.push_back(Parse(b,d))) 
s=b+strcspn(b,e), ! *s?s : (*s=0,++s) ; 
delete[ ]c; 

return  V;// . the  number  of  columns  per  row  may  differ  from  row  to  row 

}//  /S//N//S//N/  YAGENAUT@GMAIL.COM - LAST~UPDATED~20DUL2014 - 

Parse2D()  Parameters 

s  s  points  to  text  that  will  be  parsed. 

d  d  points  to  a  set  of  token-delimiting  characters.  Default  values  are  spaces, 

commas,  and  tabs. 

e  e  points  to  a  set  of  row-delimiting  characters.  Default  values  are  line  feeds,  form 

feeds,  and  carriage  returns. 

Parse2D()  Return  Value 

The  Parse2D()  function  returns  a  vector  of  vectors  of  pointers.  Each  pointer  points  to  the 
beginning  of  a  token.  The  tokens  are  stored  in  the  character  array  that  was  originally  pointed  to 
by  the  input  parameter  s. 

Parse2D()  Example 

The  following  example  uses  the  Parse2D()  function  to  parse  a  sample  block  of  text. 


#include  "y_io_2. h"// . yIo2, <cstdio>{printf },< vector > 

int  main(){//<=========================SIMPLE  EXAMPLE  FOR  THE  Parse2D()  FUNCTION 


char  s[]="1.0  2.0  3.0\n4.0  5.0  6.0\n7.0  8.0  9.0"; 
printf ^'ORIGINAL  TEXT : \n%s\n\n" , s) ; 
std: :vector<std: : vector<char*>  >B=yIo2: :Parse2D(s); 
printfC'TEXT  PARSED  USING  Parse2D( ) : \n" ) ; 

for (int  i=0,m=B.size();i<m;++i)for(int  j=0,n=B[i] .size(); j<n;++j) 
printf("%s%s",B[i][j], j==n-l?"\n":"  ,  "); 

^11  E  N  AUT  ^^GI^AI  L  •  LAS  T  PDAT  E  D^2  0  D  U  L  2  0  ^4^'**'^'**'^'**' 


7 


OUTPUT; 


ORIGINAL 

TEXT: 

1.0  2.0 

3.0 

4.0  5.0 

6.0 

7.0  8.0 

9.0 

TEXT  PARSED 

USING  Parse2D(): 

1.0  ,  2. 

0  , 

3.0 

4.0  ,  5. 

0  , 

6.0 

7.0  ,  8. 

0  , 

9.0 

5,3  PreParseQ  Function 

The  PreParseO  function  is  useful  for  situations  where  tokens  contain  delimiting  characters,  such 
as  when  filenames  contain  spaces.  The  PreParseQ  function  searches  for  delimiting  characters  that 
are  not  “protected”  and  replaces  them  with  user-specified  characters.  Characters  are  assumed  to 
be  protected  if  they  are  encompassed  by  some  sort  of  protecting  characters  (typically  quotation 
marks,  parentheses,  brackets,  or  braces). 


PreParseO  Code 


inline  char*PreParse(//<=======SELECTIVELY  REPLACE  DELIMITERS  WITH  A  CHARACTER 

char*s,//< - A  CHARACTER  ARRAY 

const  char*b="\"",//< - BEGINNING  OF  IGNORED-DELIMITERS  SECTION 

const  char*e="\"'C//< - END  OF  IGNORED-DELIMITERS  SECTION 

const  char*d="  ,\t\n\f\r",//< - DELIMITING  CHARACTERS 

char  r='#'){//< - REPLACEMENT  CHARACTER 

const  char*u; 
for(char*t=s, c=0; *t;++t){ 

if (strchr(d, *t)&&! c)*t=r; 
else  if (strchr(b, *t) )u=b, b=e,e=u, c&l?++c : --c; 
else  if (strchr(e, *t) )u=b, b=e,e=u, c&l?--c :++c; } 
return  s; 

"^11  E  N  AUT  ^^GI^AI  L  •  LAS  T^U  PDAT  E  D^2  0  D  U  L  2  0  ^4^'**'^'**'^'**' 

PreParseO  Parameters 


s  s  points  to  the  text  that  will  have  its  nonprotected  delimiting  characters  replaced. 

b  b  points  to  a  list  of  characters  that  mark  the  beginning  of  a  protected  section  of 

text.  The  default  value  is  the  double-quote  character. 

e  e  points  to  a  list  of  characters  that  mark  the  end  of  a  protected  section  of  text.  The 

default  value  is  the  double-quote  character. 

d  d  points  to  a  set  of  delimiting  characters. 

r  r  specifies  the  character  that  will  be  used  to  replace  nonprotected  delimiting 

characters. 
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PreParseO  Return  Value 

The  PreParseO  function  returns  the  input  pointer  s. 

PreParseO  Example 

The  following  example  uses  the  PreParseO  function  to  prepare  a  sample  block  of  text  for  parsing. 
The  text  is  then  parsed  using  the  ParseO  function. 


#include  "y_io_2. h"// . yIo2, <cstdio>{printf } 

int  main(){//<========================SIMPLE  EXAMPLE  FOR  THE  PreParse()  FUNCTION 


char  s[]="Alexis  ,  Beatrice  ,  Charlotte  ,  \"Dejah  Thoris\"  ,  Eunice\n"; 

printfO'ORIGINAL  TEXT:\n\n%s\n\n\n",s); 

printfO'PRE-PARSED  TEXT: \n\n%s\n\n\n",yIo2: : PreParse(s, 

printfO'PARSED  TEXT:\n\n"); 

std : : vector<char*>S=yIo2: : Parse (s, ) ; 

for (int  i=0, n=S . size( ) ; i<n;++i)printf ( "%s\n",S[i] ) ; 

^11  E  N  AUT  ^^GI^AI  L  •  LAS  T^U  PDAT  E  D^2  0  D  U  L  2  0  ^4^'**'^'**'^'**' 


OUTPUT; 


ORIGINAL  TEXT: 

Alexis  ,  Beatrice  ,  Charlotte  ,  "Dejah  Thoris"  ,  Eunice 


PRE- PARSED  TEXT: 

Alexis###Beatrice###Charlotte###"Dejah  Thoris "###Eunice 


PARSED  TEXT: 

Alexis 
Beatrice 
Charlotte 
Dejah  Thoris 
Eunice 


6.  Summary 


A  summary  sheet  is  provided  at  the  end  of  this  report.  It  presents  the  yIo2  namespace,  which 
contains  the  ReadTextFileO,  WriteTextFileO,  RemoveLineCommentsO, 
RemoveBlockCommentsO,  ParseO,  Parse2D0,  and  PreParseO  functions. 
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yIo2  Summary 


y_io_2 . h 


#ifndef  Y_I0_2_GUARD//  See  Yager^  R.3.  "Reading,  Writing,  and  Parsing  Text 

#define  Y_I0_2_GUARD//  Files  Using  C++  (Updated)"  (2014) 

#include  <cstdio>//. .fclose()jFILE,fopen()jfseek(),ftell(),printf(),SEEK_END, . . . 

#include  <cstdlib>// . exit() 

#include  <c string >// . memset(),strchr(),strlen(),strstr(),strtok() 

#include  <vector>// . vector 

inline  char+R?bcfTextffl?(//<=============================READ  TEXT  FROM  A  FILE 

const  char*f){//<--- . THE  NAME  OF  A  TEXT  FILE 

FILE*F=fopen(f , "rb”) j /*->*/ if ( ! F)printf ( "\nCan 't  find  \”%s\” . \n" ,f ),exit(l) ; 
unsigned  n; /*<-*/fseek(Fj0,SEEK_END),n=f tell (F), rewind (F); 
char*s=new  char [n+1] j /*<-*/f read(s,l,nj F) jfclose(F) , s[n]=0; 

return  sj// . note  that  s  points  to  newly  allocated  memory 

}//~~~~YAG£NAUT@GMAIL.C0M'-~~'-~ - - - ~~~~^~-.~~~~lAST~UPDATED~20]UL2014— 

inline  unsigned  i^iteTextFile(//<=========================WRITE  TEXT  TO  A  FILE 

const  char*f,//< . . THE  NAME  OF  THE  TEXT  FILE 

const  char*s,//< . THE  TEXT  TO  BE  WRITTEN 

const  char*m="wb”){//< . USE  "wb”  TO  OVERWRITE,  "ab"  TO  APPEND 

FILE*F=fopen(f,m);/*->*/if( lF)printf("\nCan't  open  \"%s\".\n",f),exit(l)j 
unsigned  n=fwrite(s,l,strlen(s),F) j/*&*/fclose(F); 

return  nj// . number  of  characters  written  to  the  file 

}//~~~~YAGENAUT@GMAIL.C0M'-~~'-~ - ^~^~~~~~~^~~~~~~lAST~UPDATEO~20]UL2014— - - 

inline  char*|emoveLineCommenti(//<=====================OVERWRITE  LINE  COMMENTS 

char*s,//< - - TEXT  THAT  MIGHT  CONTAIN  LINE  COMMENTS 

const  char*c="#",//< . BEGINNING-OF-COMMENT  INDICATOR 

char  r='  '){//< . THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

for(char*t=s;t=strstr(t,c);memset(t,rjStrcspn(t,"\n\f\r”))); 
return  s; 

}//^~~~YAGENAUT@GMAIL.C0M~~~~~ - - - - - ~~'-LAST~UPDATED~20]UL2014— — 

inline  char*^emoveBlockCommen-fl(//<=========*=========OVERWRITE  BLOCK  COMMENTS 

char*s,//< - - TEXT  THAT  MIGHT  CONTAIN  BLOCK  COMMENTS 

const  char*c='7*”,//< . BEGINNING-OF-COMMENT  INDICATOR 

const  char*e="*/",//< . END-OF -COMMENT  INDICATOR 

char  r='  ’){//< . THE  CHARACTER  THAT  WILL  BE  USED  TO  OVERWRITE  COMMENTS 

int  m=strlen(c),n=strlen(e)j 

for(char*t=s, *u;t=strstr(t, c) ;memset(tj  r,u-t+n) )if ( ! (u=strstr(t+mj  e) )) break; 

return  s;// . block  comments  without  end  indicators  aren't  overwritten 

}// - YAGENAUT@GMAIL.COM~'— - - - ~~~~~LAST~UPDATED~20]UL2014 - ~~ 

inline  std: :vector<char*>Parse(//<=========*=®=============*==========lD  PARSER 

char*s,//< . . . TEXT  THAT  WILL  BE  PARSED 

const  char*d=”  ,\t\n\f\r"){//< . DELIMITERS 

std: :vector<char*>V;/*<-*/for(s=strtok(s,d);s;s=strtok(0,d))V.push_back(s); 
return  V; 

}//^~~~YAGENAUT@GMAIL.C0M - - - LAST~UPDATED~20]UL2014 - ~~ 

inline  std: :vector<std: :vecton<char*>  >Parse2D(//<=2D  PARSER  (CALLS  ID  PARSER) 

char*s,//< . . . TEXT  THAT  WILL  BE  PARSED 

const  char*d=”  ,\t",//< . TOKEN-DELIMITING  CHARACTERS 

const  char*e="\n\f\r”){//< . ROW-DELIMITING  CHARACTERS 

std: :vector<std: : vector<char*>  >V; 
char*b, *c=new  char[strlen(d)+strlen(e)+l]; 

for(strcat(strcpy(c,d),e);*(b=s+strspn(s,c));V.push_back(Parse(b,d))) 
s=b+strcspn(b,e), !*s?s: (*s=0,++s); 
delete[]c; 

return  V;// . the  number  of  columns  per  row  may  differ  from  row  to  row 

}// - ~YAGENAUT@GMAIL.COM~~~~~~~~~~~ - - - ~~~LAST~UPDATEO~20]UL2014~~~~~~ 

inline  char*j>rePars^(//<====«=SELECTIVELY  REPLACE  DELIMITERS  WITH  A  CHARACTER 

char*s,//< . . A  CHARACTER  ARRAY 

const  char*b=”\"”,//< . BEGINNING  OF  IGNORED-DELIMITERS  SECTION 

const  char*e="\"",//< . END  OF  IGNORED-DELIMITERS  SECTION 

const  char*d=”  ,\t\n\f\r",//< . DELIMITING  CHARACTERS 

char  r='#'){//< . REPLACEMENT  CHARACTER 

const  char*u; 
for(char*t=s, c=0;*t;++t){ 

if  (stnchr(d,  ’''t)&&!  c)*t=r; 
else  if (strchr(b, *t))u=b, b=e,e=u,c&l?++c : - -c; 
else  if(stnchr(e,’''t))u=b,b=e,e=u,c&l?--c:++c;} 
return  s; 

}//.w~._~YAGENAUT@GMAIL.COM~~~ - - - ——— ~~~~LAST~UPDATEO~20]UL2014~~~~~~ 


ReadTextFile()/WriteTextFile()  Example 


#include  ”y_io_2. h"// . yIo2, <cstdio>{printf } 

int  main(){//<=====SIMPLE  EXAMPLE  FOR  WriteTextFile( )  &  ReadTextFile( )  FUNCTIONS 
yIo2: :WriteTextFile('' example.txt", "Hello  World !\n"); 
char*s=yIo2: :ReadTextFile( "example.txt"); 

printf(”%s”,s);// . display  the  contents  of  "example.txt" 

delete[]s; 

}//.. - ~YAGENAUT@GMAIL.COM~~~~ - - - ~~~~~~~LAST~UPDATED~201UL2014~~~~~~ 


Hello  World! 


RemoveLineComments()/RemoveBlockComments()  Example 


#include  "y_io_2. h"// . yIo2, <cstdio>{printf } 

int  main(){//<===SIMPLE  EXAMPLE  FOR  RemoveLineComments()  &  RemoveBlockComments() 
char  s[]="#sample  line  comment\nHello/*sample  block  comment*/World I \n"; 
printf ( "ORIGINAL  TEXT : \n%s\n\n" , s ) ; 

printf ( "LINE  COMMENTS  REMOVED : \n%s\n\n" jyIo2 : : RemoveLineComments(s) ); 
printf("LINE  &  BLOCK  COMMENTS  REMOVED: \n%s\n\n",yIo2: : Remove81ockComments(s) ) ; 
}// - YAGENAUT@GMAIL.COM~~~ - - - LAST~UPDATED~20]UL2014 - ~~ 


ORIGINAL  TEXT: 

#sample  comment 
Hello/*sample  comment*/  World! 


LINE  COMMENTS  REMOVED: 

Hello/*sample  comment*/  World! 

LINE  COMMENTS  AND  BLOCK  COMMENTS  REMOVED: 
Hello  World! 


ParseO  Example 


#include  "y_io_2.h"// . yIo2,<cstdio>{ printf}, < vector > 

int  main(){//<===========================SIMPLE  EXAMPLE  FOR  THE  Parse()  FUNCTION 

char  s[]="1.0  2.0  3.0\n4.0  5.0  6.0\n7.0  8.0  9.0"; 
printf ( "ORIGINAL  TEXT: \n%s\n\n", s) ; 
std: :vector<char*>A=yIo2: :Parse(s); 
printfC'TEXT  PARSED  USING  Parse() : \n”) ; 

for(int  i=0,m=A. size( ); i<m;++i)printf ( "%s%s",A[i] j i==m-l?”\n" : "  ,  "); 

}// - YAGENAUT@GMAIL.COM~~ - - - ~~~~LAST~UPDATED~20DUL2014 - ~~ 


OUTPUT: 


ORIGINAL  TEXT: 


4.0  5.0  6.0 
7.0  8.0  9.0 


TEXT  PARSED  USING  Parse(): 

1.0  ,  2.0  ,  3.0  ,  4.0  ,  5.0  ,  6.0  ,  7.1 


Parse2D()  Example 


#include  "y_io_2.h"// . yIo2,<cstdio>{ printf}, < vector > 

int  main(){//<=========================SIMPLE  EXAMPLE  FOR  THE  Parse2D()  FUNCTION 

char  s[]="1.0  2.0  3.0\n4.0  5.0  6.0\n7.0  8.0  9.0"; 
printf ( "ORIGINAL  TEXT: \n%s\n\n", s) ; 
std: :vector<std: :vector<char*>  >B=yIo2: :Parse2D(s); 
printfC'TEXT  PARSED  USING  Parse2D() : \n" ) ; 

for (int  i=0,m=B. size( ); i<m;++i)for(int  j=0,n=B[i] . size( ); j<n;++j ) 
printf ( "%s%s"j B[i] [j] ,j==n-l?"\n" : "  ,  "); 

}//....~.w.w.^YAGENAUT@GMAIL.COM~~ - - - - - - - ~LAST~UPDATED~20DUL2014~~~~~~ 


ORIGINAL  TEXT: 


4.0  5.0  6.0 
7.0  8.0  9.0 


TEXT  PARSED  USING  Parse2D(): 


6.0 

9.0 


PreParseO  Example 


#include  "y_io_2.h"// . yIo2, <cstdio>{ printf } 

int  main(){//<===============*========SIMPLE  EXAMPLE  FOR  THE  PreParse()  FUNCTION 

char  s[]="Alexis  ,  Beatrice  ,  Charlotte  ,  \"Dejah  Thoris\”  ,  Eunice\n"; 
printf C'ORIGINAL  TEXT: \n\n%s\n\n\n" , s); 

printf ( "PRE -PARSED  TEXT : \n\n%s\n\n\n'',yIo2: : PreParse(s, "  /') ); 

printf ("PARSED  TEXT:\n\n"); 

std : : vector <char*>S=yIo2: :Parse(s, "#\" " ) ; 

for (int  i=0,n=S.size();i<n;++i) printf ("%s\n",S[i]); 

}// - YAGENAUT@GMAIL.COM~~ - - - - - LAST~UPDATED~201UL2014 - ~~ 


ORIGINAL  TEXT: 

Alexis  ,  Beatrice  ,  Charlotte  ,  "Dejah  Thoris"  ,  Eunice 


PRE-PARSED  TEXT: 


Alexis###Beatrice###Charlotte###"Oejah  Thoris "###E unice 


PARSED  TEXT: 

Alexis 
Beatrice 
Charlotte 
Dejah  Thoris 
Eunice 
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